home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / util / libs / type1beta5.lha / type1 / README_Beta < prev    next >
Text File  |  1995-01-14  |  10KB  |  238 lines
  1. Short:    Type1library - postscript font engine
  2. Author:   asd2@midway.uchicago.edu (Amish S. Dave)
  3. Uploader: asd2@midway.uchicago.edu
  4. Type:     util/libs
  5.  
  6. Postscript Type1 fonts on the Amiga - (at last!)
  7.  
  8. type1.library
  9. t1manager
  10.  
  11. by Amish S. Dave
  12. internet email: asd2@midway.uchicago.edu
  13.  
  14.  
  15. WARNING: This is still what I would call 'beta' software!
  16. Be wary!  There are known problems/incompatibilities!!
  17. I will not be held responsible for any problems, etc.
  18.  
  19.  
  20. ###########################################################################
  21.  
  22. INTRODUCTION
  23.  
  24. The files in this distribution implement a Postscript Type1 font
  25. engine for the Amiga.  It is designed as a shared library that
  26. does for type1 fonts what 'bullet.library' does for compugraphic
  27. fonts.  In addition, a program 't1manager' is included, which is
  28. required to install, remove, and preview type1 fonts.
  29.  
  30. NOTE: t1manager REQUIRES MUI.  I think that it will work with
  31. any version of MUI from 1.2 to 2.2.  I'm quite sure that it will
  32. work with MUI 2.0 onwards.
  33.  
  34. NOTE: both programs require AmigaDOS 2.1 or higher.  I honestly
  35. am not perfectly sure anymore about 2.0 (or 2.1).  I'll say that
  36. if your system supports Compugraphic fonts, then I think
  37. type1.library and t1manager should work.
  38.  
  39.  
  40. ###########################################################################
  41. INSTALLATION and USAGE
  42.  
  43. First of all, there are two versions of the library - one compiled for
  44. 68000 and no math coprocessor (which should run on any Amiga), and
  45. one compiled for 030 AND 68882 math coprocessor.  Pick the one you
  46. intend to use.
  47.  
  48. To install, do the following from the shell, or the equivalent from WB.
  49.  
  50.     CD <this directory>
  51.     COPY libs/type1.library.0x0 libs:type1.library       ; 000 or 030
  52.     COPY t1manager/t1manager sys:system                  ; or wherever
  53.     COPY t1manager/t1manager.info sys:system         ; copy icon
  54.  
  55. Now, you should be ready to install postscript fonts.  Do this by
  56. running the 't1manager' program.  
  57.  
  58. What I do, is I have a drawer called Apps:type1fonts, which
  59. is part of my FONTS: assign.  I accomplish this by having the
  60. following line in my user-startup file:
  61.  
  62.     ASSIGN fonts: apps:type1fonts ADD                    ; Note the ADD
  63.  
  64. Now, when you run t1manager, you can select the font drawer
  65. to use.
  66.  
  67. You install a font or fonts by clicking on install and selecting
  68. the font or fonts to install.  These must be binary type1 postscript
  69. files. They commonly end in '.pfb'.  There are several programs on
  70. Aminet that I've seen that will convert different postscript font
  71. formats to .pfb format.  Find one, if your favorite font doesn't
  72. install.
  73.  
  74. IMPORTANT!!!  The installer does NOT actually copy the binary file
  75. into the fontdrawer!!!  (unlike Intellifont/Fountain).  It creates
  76. the .font and .otag files (and an empty directory) in this drawer.
  77. The actual binary file must not be deleted, or moved, or else the
  78. font will stop working.  The .otag file simply refers to the font
  79. whereever it is.  Thus, if you have some postscript fonts as part
  80. of some application, say Pagestream, you don't have to have two
  81. copies - type1.library will read the font directly from the
  82. directory it was in when you installed the font.
  83.  
  84. To see a preview of an installed font, just double click on the font's
  85. name.  The preview will appear on the bottom panel.
  86.  
  87. Etc.
  88.  
  89. At this point, barring bugs, you should be able to select postscript
  90. fonts wherever you would otherwise select compugraphic fonts.
  91.  
  92. BETA: Note, however, that as of this beta version, there are still
  93. some substantial incompatibilities... Be forewarned.
  94.  
  95.  
  96.  
  97. ###########################################################################
  98. ###########################################################################
  99. WARNINGS/DISCLAIMERS/COPYRIGHT STUFF
  100. ###########################################################################
  101. I don't have the time or desire to understand any of the legal
  102. mumbo jumbo that's supposed to go here.  So what I'll put here
  103. will be in plain english and not legalese:
  104.  
  105. First of all: you can't sell this for money - note carefully
  106. the 'without fee' clause in the following blurb.  Insofar as
  107. the notice below permits, I think that the interpretation
  108. should be that Fred Fish-type prices for distribution are
  109. okay; selling this software by itself, or as part of a package
  110. where this software is part of the advertisement, is not okay.
  111.  
  112. Also: I disclaim any responsibility for anything regarding
  113. type1.library, t1manager, or any associated files, usage, etc.
  114. In other words, if anything goes wrong, it's not my fault.  In
  115. fact, I'll just say that it is likely that things will go wrong
  116. - if you choose to use or look at this software, be forewarned,
  117. and don't blame me!!
  118.  
  119. Furthermore, I don't claim too much credit for the software here:
  120. I just used, copied, modified and am now distributing software
  121. that was donated to the X Consortium by others.  The underlying
  122. font engine was written apparently for use with X-windows servers-
  123. I didn't write it, and don't claim exceptional knowledge about it.
  124. Here's the blurb that I think I'm obligated to add here:
  125.  
  126. /* Copyright International Business Machines, Corp. 1991
  127.  * All Rights Reserved
  128.  * Copyright Lexmark International, Inc. 1991
  129.  * All Rights Reserved
  130.  * Portions Copyright (c) 1990 Adobe Systems Incorporated.
  131.  * All Rights Reserved
  132.  *
  133.  * License to use, copy, modify, and distribute this software and its
  134.  * documentation for any purpose and without fee is hereby granted,
  135.  * provided that the above copyright notice appear in all copies and that
  136.  * both that copyright notice and this permission notice appear in
  137.  * supporting documentation, and that the name of IBM or Lexmark or Adobe
  138.  * not be used in advertising or publicity pertaining to distribution of
  139.  * the software without specific, written prior permission.
  140.  *
  141.  * IBM, LEXMARK, AND ADOBE PROVIDE THIS SOFTWARE "AS IS", WITHOUT ANY
  142.  * WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT
  143.  * LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  144.  * PARTICULAR PURPOSE, AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.  THE
  145.  * ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE, INCLUDING
  146.  * ANY DUTY TO SUPPORT OR MAINTAIN, BELONGS TO THE LICENSEE.  SHOULD ANY
  147.  * PORTION OF THE SOFTWARE PROVE DEFECTIVE, THE LICENSEE (NOT IBM,
  148.  * LEXMARK, OR ADOBE) ASSUMES THE ENTIRE COST OF ALL SERVICING, REPAIR AND
  149.  * CORRECTION.  IN NO EVENT SHALL IBM, LEXMARK, OR ADOBE BE LIABLE FOR ANY
  150.  * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
  151.  * RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
  152.  * CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  153.  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  154.  */
  155.  
  156. The above applies only to portions of the code that contain the message
  157. at the top of the source.  Other source files (of which *some* begin with
  158. my first name; hey, what can I say :->  some people choose to use foo
  159. and bar - I use my first name!) were written by me, and probably contain
  160. Amiga-specific code. For these files, the same license to use, copy, etc.
  161. and the same proviso regarding warranties applies, with AMISH S. DAVE
  162. substituting for IBM, LEXMARK, and ADOBE.
  163.  
  164. Also, I used some enhancements to the X windows code provided by HP:
  165.  
  166. THE HP XLFD ENHANCEMENTS ARE PROVIDED "AS IS", WITHOUT ANY WARRANTIES OF
  167. ANY KIND, EITHER EXPRESS OR IMPLIED.  IN NO EVENT SHALL HEWLETT-PACKARD
  168. BE LIABLE FOR ANY SPECIAL, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY
  169. DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
  170. IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
  171. OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THESE
  172. ENHANCEMENTS.
  173.  
  174. ###########################################################################
  175.  
  176. WHERE DID IT COME FROM?
  177.  
  178. I started with the postscript rasterizer in the contrib distribution
  179. of X11R5 (X-Windows).  I have since used the X11R6 type1 font rasterizer,
  180. which is part of its core distribution.  I have also used some patches
  181. by HP that were on the ftp.x.org ftp site in the contrib section.
  182.  
  183. What I did was adapt it to look like the Amiga's compugraphic
  184. font engine (bullet.library).  My only source of information on
  185. writing such libraries was from the includes and by looking at
  186. what was being passed to and from bullet.library when diskfont
  187. called it (by SetPatch()-ing bullet.library).
  188.  
  189. After adapting the code to the Amiga, I sped it up, by re-writing some
  190. portions of the code, tweaking other portions, etc.  In some cases, I
  191. wrote assembly routines to replace C code.  These were my first 680x0
  192. assembly routines...
  193.  
  194. Then I whipped up a MUI utility to install/remove/preview fonts.  This
  195. was also my first MUI program.
  196.  
  197. ###########################################################################
  198.  
  199. WHERE IS IT GOING
  200.  
  201. I haven't had the time to work on this 'pet project' for a while. I
  202. don't anticipate finding the time in the near future.  Thus, I'm
  203. releasing now so as to encourage further development by others.  I
  204. personally consider this software to be at a 'beta' level - it certainly
  205. isn't polished enough yet for a 1.0 release, I think.
  206.  
  207. Hopefully, people will start working on this now.  I ask that people
  208. who work on this to please make public, or send me any updates or
  209. changes they make.  My intention is for there to only be a single
  210. type1.library for the Amiga, not a confusing litany of 14.15XYZ,
  211. 1.0K00L, ABC2.0 versions, each somewhat different...  That would suck.
  212.  
  213. ###########################################################################
  214.  
  215. KNOWN PROBLEMS
  216.  
  217. Most of the problems remaining stem from my not correctly supporting
  218. the glm_Width field of the glyphmap structure that I return.  Right
  219. now I put 1.0 for every character.  Also, there are many tags that I
  220. don't support yet.  The TODO file accompanying this release lists a
  221. few of the more important changes that need to be made.
  222.  
  223. ###########################################################################
  224.  
  225. THANKS TO:
  226.  
  227. Gregory Block - for code fragments, encouragement, insistance, harrassment
  228. (:->) and bug reports.
  229.  
  230. ###########################################################################
  231.  
  232.  
  233.  
  234. --
  235. Amish S. Dave                                    University of Chicago
  236. asd2@midway.uchicago.edu                         Biology Grad. Student
  237.  
  238.